sim-mirror 2.3.0__tar.gz → 2.5.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (455) hide show
  1. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/PKG-INFO +29 -16
  2. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/README.md +28 -15
  3. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/docs/README.md +3 -0
  4. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/claude-code-cli/README.md +2 -2
  5. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/codex/README.md +1 -1
  6. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/cursor/README.md +1 -1
  7. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/fastapi-embed/README.md +1 -1
  8. sim_mirror-2.5.0/examples/token-budget/README.md +48 -0
  9. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Recording.swift +45 -1
  10. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Wire.swift +1 -1
  11. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/RecordingRenderer.swift +29 -26
  12. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/RecordingTests.swift +60 -0
  13. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/http.schema.json +42 -7
  14. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/_version.py +1 -1
  15. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/provider.py +15 -2
  16. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/runner.py +20 -0
  17. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/context.py +3 -1
  18. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/doctor.py +3 -2
  19. sim_mirror-2.5.0/src/sim_mirror/cli/record.py +118 -0
  20. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/stop.py +88 -13
  21. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/tools.py +2 -5
  22. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/wda.py +86 -11
  23. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/model.py +4 -0
  24. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/schema.py +22 -2
  25. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/base.py +18 -1
  26. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/helper_process.py +45 -1
  27. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/capture.py +8 -1
  28. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/connector.py +26 -4
  29. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/wda.py +105 -5
  30. sim_mirror-2.5.0/src/sim_mirror/connectors/iphone/wda_client.py +347 -0
  31. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/wda_roles.py +182 -26
  32. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/native/helper.py +21 -10
  33. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/actions.py +281 -74
  34. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/backends.py +3 -1
  35. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/control.py +65 -7
  36. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/device_logs.py +45 -15
  37. sim_mirror-2.5.0/src/sim_mirror/core/drivers.py +124 -0
  38. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/instance.py +38 -1
  39. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/manager.py +264 -86
  40. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/recordings.py +314 -51
  41. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/render.py +10 -4
  42. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/runtime.py +41 -16
  43. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/touch.py +10 -2
  44. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/app.py +49 -7
  45. sim_mirror-2.5.0/src/sim_mirror/daemon/lease.py +76 -0
  46. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/checks.py +6 -3
  47. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/real_devices.py +102 -8
  48. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/host_copy.py +42 -1
  49. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/hosting.py +2 -0
  50. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/mcp/launcher.py +136 -26
  51. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/mcp/relay.py +130 -20
  52. sim_mirror-2.5.0/src/sim_mirror/perception/backtracking.py +276 -0
  53. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/occlusion.py +54 -7
  54. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/ocr.py +25 -2
  55. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/readers.py +6 -4
  56. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/snapshot.py +73 -15
  57. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/vision/helper.py +97 -7
  58. sim_mirror-2.5.0/src/sim_mirror/perception/wait.py +236 -0
  59. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/json_lines.py +74 -1
  60. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/protocol/_generated.py +42 -1
  61. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/http_routes.py +17 -9
  62. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/log_redaction.py +25 -2
  63. sim_mirror-2.5.0/src/sim_mirror/server/static/viewer/start.js +35 -0
  64. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fakes.py +12 -0
  65. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/wda.py +23 -3
  66. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/act.py +21 -4
  67. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/context.py +23 -7
  68. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/device.py +96 -31
  69. sim_mirror-2.5.0/src/sim_mirror/tools/record.py +141 -0
  70. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/registry.py +9 -9
  71. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/results.py +5 -2
  72. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/schemas.py +95 -13
  73. sim_mirror-2.5.0/src/sim_mirror/tools/screenshot.py +136 -0
  74. sim_mirror-2.5.0/src/sim_mirror/tools/snapshot.py +34 -0
  75. sim_mirror-2.3.0/examples/token-budget/README.md +0 -23
  76. sim_mirror-2.3.0/src/sim_mirror/cli/record.py +0 -75
  77. sim_mirror-2.3.0/src/sim_mirror/connectors/iphone/wda_client.py +0 -190
  78. sim_mirror-2.3.0/src/sim_mirror/daemon/lease.py +0 -46
  79. sim_mirror-2.3.0/src/sim_mirror/perception/wait.py +0 -73
  80. sim_mirror-2.3.0/src/sim_mirror/server/static/viewer/start.js +0 -35
  81. sim_mirror-2.3.0/src/sim_mirror/tools/record.py +0 -93
  82. sim_mirror-2.3.0/src/sim_mirror/tools/screenshot.py +0 -28
  83. sim_mirror-2.3.0/src/sim_mirror/tools/snapshot.py +0 -23
  84. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/.gitignore +0 -0
  85. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/LICENSE +0 -0
  86. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/NOTICE +0 -0
  87. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/THIRD_PARTY_LICENSES.md +0 -0
  88. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/docs/media/README.md +0 -0
  89. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/README.md +0 -0
  90. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/android-app/README.md +0 -0
  91. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/custom-connector/README.md +0 -0
  92. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/embed-host/README.md +0 -0
  93. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/iframe/README.md +0 -0
  94. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/examples/web-component/README.md +0 -0
  95. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Package.swift +0 -0
  96. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Accessibility.swift +0 -0
  97. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Arguments.swift +0 -0
  98. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Capture.swift +0 -0
  99. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/FrameScheduler.swift +0 -0
  100. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Input.swift +0 -0
  101. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/JSON.swift +0 -0
  102. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Orientation.swift +0 -0
  103. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Requests.swift +0 -0
  104. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Rotation.swift +0 -0
  105. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Screen.swift +0 -0
  106. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Server.swift +0 -0
  107. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperCore/Video.swift +0 -0
  108. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/AccessibilityReader.swift +0 -0
  109. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/CaptureDevice.swift +0 -0
  110. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/Disclaimed.swift +0 -0
  111. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/Framebuffer.swift +0 -0
  112. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/Frameworks.swift +0 -0
  113. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/H264Stream.swift +0 -0
  114. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/HIDTransports.swift +0 -0
  115. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/Pictures.swift +0 -0
  116. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/PixelSource.swift +0 -0
  117. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/ScreenFeed.swift +0 -0
  118. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/SimDeviceHandle.swift +0 -0
  119. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/SimulatorDevice.swift +0 -0
  120. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/UnixSocket.swift +0 -0
  121. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/UsbCapture.swift +0 -0
  122. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/HelperPlatform/Warming.swift +0 -0
  123. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/ObjCGuard/ObjCGuard.m +0 -0
  124. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/ObjCGuard/include/ObjCGuard.h +0 -0
  125. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Sources/sim-mirror-helper/main.swift +0 -0
  126. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Support/Info.plist +0 -0
  127. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/Fixtures/wire-vectors.json +0 -0
  128. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/AccessibilityTests.swift +0 -0
  129. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/ArgumentsTests.swift +0 -0
  130. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/CaptureTests.swift +0 -0
  131. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/InputTests.swift +0 -0
  132. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/OrientationTests.swift +0 -0
  133. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/PictureTests.swift +0 -0
  134. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/RotationTests.swift +0 -0
  135. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/ServerTests.swift +0 -0
  136. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/helper/Tests/HelperCoreTests/WireTests.swift +0 -0
  137. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/README.md +0 -0
  138. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/error-inactive.json +0 -0
  139. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/error-unauthorized.json +0 -0
  140. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/hierarchy-alert.json +0 -0
  141. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/hierarchy-keyboard.json +0 -0
  142. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/hierarchy-swiftui.json +0 -0
  143. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/hierarchy-tagged.json +0 -0
  144. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/hierarchy-uikit.json +0 -0
  145. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/examples/listing.json +0 -0
  146. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/hierarchy.schema.json +0 -0
  147. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/app-sdk/v1/listing.schema.json +0 -0
  148. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/agent-event.schema.json +0 -0
  149. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/client-input.schema.json +0 -0
  150. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/close-codes.json +0 -0
  151. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/common.schema.json +0 -0
  152. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/constants.json +0 -0
  153. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/hello.schema.json +0 -0
  154. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/input-refused.schema.json +0 -0
  155. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/screen-text.schema.json +0 -0
  156. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/settings.schema.json +0 -0
  157. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/status.schema.json +0 -0
  158. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/protocol/v1/stream.schema.json +0 -0
  159. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/pyproject.toml +0 -0
  160. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/scripts/hatch_build.py +0 -0
  161. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/__init__.py +0 -0
  162. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/__main__.py +0 -0
  163. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/api.py +0 -0
  164. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/__init__.py +0 -0
  165. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/checkouts.py +0 -0
  166. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/destination.py +0 -0
  167. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/gradle.py +0 -0
  168. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/gradle_log.py +0 -0
  169. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/junit.py +0 -0
  170. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/project_files.py +0 -0
  171. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/schemes.py +0 -0
  172. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/source.py +0 -0
  173. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/stamp.py +0 -0
  174. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/wda.py +0 -0
  175. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/xcodebuild.py +0 -0
  176. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/xcresult.py +0 -0
  177. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/build/xctestplan.py +0 -0
  178. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/__init__.py +0 -0
  179. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/android.py +0 -0
  180. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/app_command.py +0 -0
  181. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/config_command.py +0 -0
  182. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/device_command.py +0 -0
  183. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/devices.py +0 -0
  184. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/helper.py +0 -0
  185. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/main.py +0 -0
  186. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/mcp.py +0 -0
  187. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/open_viewer.py +0 -0
  188. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/serve.py +0 -0
  189. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/settings_command.py +0 -0
  190. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/tokens.py +0 -0
  191. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/version.py +0 -0
  192. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/cli/xcode.py +0 -0
  193. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/__init__.py +0 -0
  194. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/discovery.py +0 -0
  195. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/env.py +0 -0
  196. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/observe_languages.py +0 -0
  197. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/provenance.py +0 -0
  198. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/settings_store.py +0 -0
  199. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/toml_source.py +0 -0
  200. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/config/writer.py +0 -0
  201. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/__init__.py +0 -0
  202. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/__init__.py +0 -0
  203. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/adb_input.py +0 -0
  204. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/connector.py +0 -0
  205. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/geometry.py +0 -0
  206. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/keys.py +0 -0
  207. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/scrcpy.py +0 -0
  208. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/scrcpy_roles.py +0 -0
  209. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/scrcpy_source.py +0 -0
  210. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/screen.py +0 -0
  211. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/android/uiautomator.py +0 -0
  212. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/__init__.py +0 -0
  213. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/client.py +0 -0
  214. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/discovery.py +0 -0
  215. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/document.py +0 -0
  216. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/errors.py +0 -0
  217. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/merge.py +0 -0
  218. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/reader.py +0 -0
  219. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/app/wire.py +0 -0
  220. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/__init__.py +0 -0
  221. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/companion.py +0 -0
  222. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/connector.py +0 -0
  223. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/engine.py +0 -0
  224. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/frameworks.py +0 -0
  225. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/orientation.py +0 -0
  226. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/proto/__init__.py +0 -0
  227. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/proto/idb.proto +0 -0
  228. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/proto/idb_grpc.py +0 -0
  229. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/idb/proto/idb_pb2.py +0 -0
  230. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/__init__.py +0 -0
  231. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/cable.py +0 -0
  232. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/screen.py +0 -0
  233. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/wda_setup.py +0 -0
  234. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/iphone/wda_source.py +0 -0
  235. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/mcpbridge/__init__.py +0 -0
  236. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/mcpbridge/client.py +0 -0
  237. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/mcpbridge/connector.py +0 -0
  238. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/mcpbridge/hierarchy.py +0 -0
  239. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/mcpbridge/merge.py +0 -0
  240. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/mcpbridge/reader.py +0 -0
  241. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/native/__init__.py +0 -0
  242. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/native/client.py +0 -0
  243. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/native/connector.py +0 -0
  244. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/native/wire.py +0 -0
  245. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/registry.py +0 -0
  246. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/simctl/__init__.py +0 -0
  247. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/simctl/capture.py +0 -0
  248. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/connectors/simctl/connector.py +0 -0
  249. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/__init__.py +0 -0
  250. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/android_backend.py +0 -0
  251. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/android_control.py +0 -0
  252. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/android_devices.py +0 -0
  253. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/availability.py +0 -0
  254. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/device_changes.py +0 -0
  255. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/device_settings.py +0 -0
  256. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/devices.py +0 -0
  257. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/events.py +0 -0
  258. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/frames.py +0 -0
  259. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/gestures.py +0 -0
  260. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/reaper.py +0 -0
  261. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/recording_sources.py +0 -0
  262. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/refusals.py +0 -0
  263. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/screen_input.py +0 -0
  264. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/screen_relay.py +0 -0
  265. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/signing.py +0 -0
  266. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/status.py +0 -0
  267. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/text_entry.py +0 -0
  268. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/text_overlay.py +0 -0
  269. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/core/tickets.py +0 -0
  270. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/__init__.py +0 -0
  271. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/auth.py +0 -0
  272. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/confirmations.py +0 -0
  273. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/health.py +0 -0
  274. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/lifecycle.py +0 -0
  275. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/passes.py +0 -0
  276. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/pauses.py +0 -0
  277. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/policy.py +0 -0
  278. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/daemon/tokens.py +0 -0
  279. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/__init__.py +0 -0
  280. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/android.py +0 -0
  281. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/macos.py +0 -0
  282. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/report.py +0 -0
  283. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/tap.py +0 -0
  284. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/doctor/worktree.py +0 -0
  285. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/mcp/__init__.py +0 -0
  286. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/__init__.py +0 -0
  287. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/bar_names.py +0 -0
  288. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/budget.py +0 -0
  289. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/imagehash.py +0 -0
  290. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/in_front.py +0 -0
  291. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/model.py +0 -0
  292. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/orientation.py +0 -0
  293. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/settle.py +0 -0
  294. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/system_alert.py +0 -0
  295. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/vision/__init__.py +0 -0
  296. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/vision/probe.py +0 -0
  297. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/perception/vision/text_recognizer.swift +0 -0
  298. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/__init__.py +0 -0
  299. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/adb.py +0 -0
  300. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/android_sdk.py +0 -0
  301. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/codesign.py +0 -0
  302. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/developer_dir.py +0 -0
  303. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/device_data.py +0 -0
  304. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/devicectl.py +0 -0
  305. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/emulator.py +0 -0
  306. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/errors.py +0 -0
  307. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/git.py +0 -0
  308. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/identifiers.py +0 -0
  309. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/images.py +0 -0
  310. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/java.py +0 -0
  311. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/keyboard.py +0 -0
  312. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/keychain.py +0 -0
  313. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/lockdown.py +0 -0
  314. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/process.py +0 -0
  315. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/simctl.py +0 -0
  316. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/swift.py +0 -0
  317. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/swiftpm.py +0 -0
  318. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/usbmux.py +0 -0
  319. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/xcode.py +0 -0
  320. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/platform/xcrun.py +0 -0
  321. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/protocol/__init__.py +0 -0
  322. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/protocol/messages.py +0 -0
  323. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/py.typed +0 -0
  324. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/scope.py +0 -0
  325. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/seams.py +0 -0
  326. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/__init__.py +0 -0
  327. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/agent_routes.py +0 -0
  328. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/envelope.py +0 -0
  329. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/pages.py +0 -0
  330. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/security.py +0 -0
  331. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/settings_routes.py +0 -0
  332. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/settings_view.py +0 -0
  333. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/socket_routes.py +0 -0
  334. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/static/viewer/embed.html +0 -0
  335. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/server/static/viewer/index.html +0 -0
  336. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/storage/__init__.py +0 -0
  337. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/storage/app_support.py +0 -0
  338. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/storage/claims.py +0 -0
  339. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/storage/private.py +0 -0
  340. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/__init__.py +0 -0
  341. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/adb.py +0 -0
  342. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/android_sdk.py +0 -0
  343. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/app_sdk.py +0 -0
  344. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/asgi.py +0 -0
  345. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/checkouts.py +0 -0
  346. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/contract.py +0 -0
  347. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/daemon.py +0 -0
  348. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-am-start-bad.txt +0 -0
  349. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-am-start.txt +0 -0
  350. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-logcat-uid.txt +0 -0
  351. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-package-missing.txt +0 -0
  352. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-package.txt +0 -0
  353. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-pm-uid.txt +0 -0
  354. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-uiautomator-landscape.xml +0 -0
  355. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-uiautomator-search.xml +0 -0
  356. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-uiautomator-settings.xml +0 -0
  357. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-window-search.txt +0 -0
  358. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/android-window-settings.txt +0 -0
  359. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-alert-ios27.json +0 -0
  360. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-alert-ipad-landscape-left-ios26.json +0 -0
  361. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-alert-ipad-upside-down-ios26.json +0 -0
  362. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-alert-turned-left-ios26.json +0 -0
  363. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-alert-turned-right-ios26.json +0 -0
  364. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-alert-upright-ios26.json +0 -0
  365. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-app-sdk-alert.json +0 -0
  366. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-app-sdk-keyboard.json +0 -0
  367. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-app-sdk-swiftui.json +0 -0
  368. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-app-sdk-tagged.json +0 -0
  369. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-app-sdk-uikit.json +0 -0
  370. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-files-navigation-bar-de-ios26.json +0 -0
  371. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-files-tab-bar-de-ios26.json +0 -0
  372. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-floating-button-ios26.json +0 -0
  373. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-health-tab-bar-ios26.json +0 -0
  374. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-home-complete.json +0 -0
  375. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-home-ios27.json +0 -0
  376. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-keyboard-ios27.json +0 -0
  377. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-native-files-navigation-bar-de-ios26.json +0 -0
  378. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-probe-ios27.json +0 -0
  379. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-probe-ipad-upside-down-ios26.json +0 -0
  380. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-probe-rotated-left-ios26.json +0 -0
  381. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-safari-ios27.json +0 -0
  382. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-safari-typed.json +0 -0
  383. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-settings-back-button-ios26.json +0 -0
  384. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-settings-interactable.json +0 -0
  385. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-settings-ios27.json +0 -0
  386. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-settings-search-field-ios26.json +0 -0
  387. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-settings-toolbar-ja-ios26.json +0 -0
  388. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-settings-under-navigation-bar-ios26.json +0 -0
  389. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-turned-landscape-left-ios26.json +0 -0
  390. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-turned-landscape-right-ios26.json +0 -0
  391. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-turned-maps-alert-ios26.json +0 -0
  392. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-turned-portrait-ios26.json +0 -0
  393. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-turned-reminders-portrait-ios26.json +0 -0
  394. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-turned-safari-landscape-left-ios26.json +0 -0
  395. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/ax-turned-safari-landscape-right-ios26.json +0 -0
  396. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/development-certificate.pem +0 -0
  397. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-appearance.json +0 -0
  398. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-apps.json +0 -0
  399. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-devices.json +0 -0
  400. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-displays.json +0 -0
  401. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-launch-missing.json +0 -0
  402. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-launch.json +0 -0
  403. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-lock-state.json +0 -0
  404. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-processes.json +0 -0
  405. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/devicectl-screenshot.json +0 -0
  406. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/gradle-aapt-error.log +0 -0
  407. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/gradle-kotlin-error.log +0 -0
  408. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/gradle-output-metadata.json +0 -0
  409. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/gradle-test-failure.log +0 -0
  410. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/junit-android-failure.xml +0 -0
  411. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/mcpbridge-answers.json +0 -0
  412. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/mcpbridge-hierarchy-alert.txt +0 -0
  413. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/mcpbridge-hierarchy-home.txt +0 -0
  414. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/mcpbridge-hierarchy-keyboard.txt +0 -0
  415. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/mcpbridge-hierarchy-probe.txt +0 -0
  416. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/mcpbridge-hierarchy-safari.txt +0 -0
  417. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/mcpbridge-hierarchy-settings.txt +0 -0
  418. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/simctl-devices.json +0 -0
  419. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/simctl-runtimes.json +0 -0
  420. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcodebuild-list-names.json +0 -0
  421. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcodebuild-list.json +0 -0
  422. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcodebuild-settings-test.json +0 -0
  423. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcodebuild-settings.json +0 -0
  424. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcodebuild-test-plans-none.json +0 -0
  425. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcodebuild-test-plans.json +0 -0
  426. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-build-broken.json +0 -0
  427. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-build-ok.json +0 -0
  428. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-build-results-unbuilt.json +0 -0
  429. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-summary-retries.json +0 -0
  430. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-summary-swift-testing-xcode27.json +0 -0
  431. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-summary-swift-testing.json +0 -0
  432. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-summary-unbuilt.json +0 -0
  433. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-summary.json +0 -0
  434. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-tests-retries.json +0 -0
  435. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-tests-swift-testing-xcode27.json +0 -0
  436. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-tests-swift-testing.json +0 -0
  437. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcresult-test-tests.json +0 -0
  438. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcscheme-staging.xcscheme +0 -0
  439. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xcscheme-test-plans.xcscheme +0 -0
  440. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xctestplan-everything.xctestplan +0 -0
  441. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/fixtures/xctestplan-units-only.xctestplan +0 -0
  442. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/gradle.py +0 -0
  443. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/guards.py +0 -0
  444. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/native.py +0 -0
  445. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/pictures.py +0 -0
  446. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/recording.py +0 -0
  447. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/rig.py +0 -0
  448. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/scrcpy.py +0 -0
  449. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/usbmux.py +0 -0
  450. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/testing/vision.py +0 -0
  451. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/__init__.py +0 -0
  452. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/tools/app.py +0 -0
  453. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/src/sim_mirror/validation.py +0 -0
  454. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/tests/unit/protocol/test_messages.py +0 -0
  455. {sim_mirror-2.3.0 → sim_mirror-2.5.0}/viewer/README.md +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: sim-mirror
3
- Version: 2.3.0
3
+ Version: 2.5.0
4
4
  Summary: Mirror and drive iOS Simulators and real iPhones from Claude Code, CLI agents and the browser.
5
5
  Project-URL: Homepage, https://github.com/AndrewKochulab/sim-mirror
6
6
  Project-URL: Documentation, https://github.com/AndrewKochulab/sim-mirror/tree/main/docs
@@ -58,14 +58,15 @@ shows exactly what your AI agent is about to tap, and token-efficient UI snapsho
58
58
  text instead of screenshots. Record any screen as an MP4 or a GIF for a pull request. Works with Claude Code, Codex,
59
59
  Cursor and any other MCP client.
60
60
 
61
- > **Status: 2.3.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
61
+ > **Status: 2.4.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
62
62
  > release to [what SimMirror promises not to break](docs/stability.md). 2.0 brought real iPhones and iPads beside the
63
63
  > simulators -- live over the cable, driven through WebDriverAgent -- and records any screen as an MP4 or a GIF. 2.1
64
64
  > reads and touches apps turned to landscape, keeps taps off what a tab bar covers, builds the worktree the agent works
65
65
  > in, and adds observe mode for walkthroughs on accounts an agent must not change. 2.2 adds Android emulators and
66
66
  > phones, with the same viewer, cursor and tools. 2.3 attaches a real device again by itself once a pulled cable is
67
- > back, tells an agent why it cannot touch one, and checks one before a run with `sim_device health`. It removes
68
- > nothing 1.x promised.
67
+ > back, tells an agent why it cannot touch one, and checks one before a run with `sim_device health`. 2.4 leaves a
68
+ > phone a person took back alone, records as long as it ran, reads long screens without locking WebDriverAgent up, waits
69
+ > for exact words, and lets one agent at a time drive a real device. It removes nothing 1.x promised.
69
70
 
70
71
  ## Why SimMirror
71
72
 
@@ -79,6 +80,9 @@ Cursor and any other MCP client.
79
80
  share its own views, so icon-only buttons and hand-drawn controls read by name.
80
81
  - **Test on a real iPhone.** Plug it in and it sits beside the simulators: live over the cable at up to 60 fps, touched
81
82
  and typed on from the browser or by an agent, and given back everything SimMirror changed on it.
83
+ - **Check connection recovery.** Open Control Center on a real iPhone to manage Wi-Fi and Bluetooth connections or
84
+ toggle airplane mode, then return to your app to check how it reconnects to a BLE or Wi-Fi accessory.
85
+ See [the connectivity workflow](docs/real-devices.md#connectivity-workflows).
82
86
  - **Show what happened.** Record a flow as an MP4 or a GIF with every touch drawn in, and put it in a pull request.
83
87
 
84
88
  ## Install
@@ -93,16 +97,17 @@ Cursor and any other MCP client.
93
97
  **Any MCP client**, as a stdio server:
94
98
 
95
99
  ```sh
96
- claude mcp add sim-mirror -- uvx --from sim-mirror==2.3.0 sim-mirror mcp
100
+ claude mcp add sim-mirror -- uvx --from sim-mirror==2.5.0 sim-mirror mcp
97
101
  ```
98
102
 
99
103
  Configurations for [Codex](docs/clients/codex.md), [Cursor](docs/clients/cursor.md) and
100
104
  [other clients](docs/clients/other-mcp.md).
105
+ The plugin includes four [workflow skills](docs/clients/skills.md); the release also packages them for Codex and Cursor.
101
106
 
102
107
  **The command**, for `sim-mirror open`, `doctor` and the rest:
103
108
 
104
109
  ```sh
105
- uv tool install sim-mirror==2.3.0
110
+ uv tool install sim-mirror==2.5.0
106
111
  # or
107
112
  brew install andrewkochulab/tap/sim-mirror
108
113
  ```
@@ -164,7 +169,7 @@ gesture or a hand-drawn control reads by name, and `.simMirror("Settings")` name
164
169
  of it is in a Release build. See [The app SDK](docs/app-sdk.md).
165
170
 
166
171
  **Real devices.** A cabled iPhone or iPad shows up beside the simulators, and an agent can switch to it
167
- (`sim_device list` and `choose`): its live screen over the cable, at about 55 frames a second; its apps, logs, look and
172
+ (`sim_device list` and `choose`): its live screen over the cable; its apps, logs, look and
168
173
  location through Xcode's `devicectl`; and touching, typing and its element tree through WebDriverAgent, set up once
169
174
  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
170
175
  the cable, and what SimMirror changes on it is put back when it is let go. See [Real devices](docs/real-devices.md).
@@ -206,19 +211,26 @@ set build.tools true`.
206
211
  ## Measure the token cost
207
212
 
208
213
  `benchmarks/tool_budget.py` calls each read-only tool through the same MCP relay a client uses and prints each answer's
209
- bytes, estimated tokens and latency on your own screens; see [the token budget example](examples/token-budget/). On
210
- an iPhone 17 Pro simulator (iOS 26.5, idb connector) showing Settings → General, 5 calls each (2026-09-16):
214
+ bytes, estimated tokens and latency on your own screens; see [the token budget example](examples/token-budget/).
215
+ Measured with SimMirror 2.4.0 on an iOS simulator using the native connector, showing Settings → General:
216
+ 30 calls per tool after a separate initial round and 3 warmup rounds (2026-10-29). Host and device details are omitted
217
+ from the public report for privacy.
211
218
 
212
219
  | Call | Tool | Bytes | Tokens (est.) | p50 ms | p95 ms |
213
220
  |---|---|---:|---:|---:|---:|
214
- | device info | `sim_device` | 265 | 46 | 2.9 | 3.6 |
215
- | snapshot, full | `sim_snapshot` | 561 | 112 | 64.8 | 76.4 |
216
- | snapshot, diff of an unchanged screen | `sim_snapshot` | 83 | 5 | 63.2 | 64.8 |
217
- | screenshot, 400 px wide | `sim_screenshot` | 62222 | 469 | 8.2 | 8.9 |
218
- | screenshot, 1200 px wide | `sim_screenshot` | 276472 | 4181 | 20.4 | 21.9 |
221
+ | device info | `sim_device` | 275 | 49 | 260.1 | 282.9 |
222
+ | snapshot, full | `sim_snapshot` | 561 | 112 | 74.3 | 83.3 |
223
+ | snapshot, diff of an unchanged screen | `sim_snapshot` | 83 | 5 | 66.5 | 73.5 |
224
+ | screenshot, 400 px wide | `sim_screenshot` | 55958 | 469 | 15.5 | 17.0 |
225
+ | screenshot, 1200 px wide | `sim_screenshot` | 251484 | 4181 | 24.2 | 25.8 |
226
+
227
+ On a physical iOS device over USB with WebDriverAgent, the same 30-round run measured 199 estimated tokens for a
228
+ full snapshot (p50 859.1 ms), 5 for an unchanged-screen diff (817.9 ms), and 469 for a 400-pixel screenshot (31.4 ms).
219
229
 
220
230
  Bytes are the whole answer, an image's base64 included; tokens are estimates (text at about 4 characters a token,
221
- an image at about 750 pixels a token).
231
+ an image at about 750 pixels a token), not billed usage or whole-task costs. All measured calls succeeded. See the
232
+ [performance report](docs/performance.md) for real-iPhone results, initial-call timings, raw samples and the older
233
+ baseline. Different connectors and environments make these separate observations, not a before/after speedup claim.
222
234
 
223
235
  ## Compatibility
224
236
 
@@ -256,7 +268,8 @@ the [command line](docs/reference/cli.md) and the [protocol](docs/reference/prot
256
268
  | **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 |
257
269
  | **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 |
258
270
  | **v2.2** | Android emulators and phones with the same viewer, cursor and tools: adb, scrcpy's live screen, and Gradle builds |
259
- | **v2.3** (now) | Real devices that recover from a pulled cable by themselves, `sim_device health`, an agent told why a device cannot be touched, and a text reader a slow reading no longer locks out |
271
+ | **v2.3** | Real devices that recover from a pulled cable by themselves, `sim_device health`, an agent told why a device cannot be touched, and a text reader a slow reading no longer locks out |
272
+ | **v2.4** (now) | Agents that hold up on a real iPhone: WebDriverAgent left alone once a person takes the phone back, recordings as long as they ran, long screens read without locking up, exact and regex waits, refs checked before a tap, iOS 27's floating search bar, and one agent at a time per device |
260
273
  | **Website & launch** | Landing page, video tutorials and guides |
261
274
 
262
275
  See [ROADMAP.md](ROADMAP.md) and the [milestones](https://github.com/AndrewKochulab/sim-mirror/milestones). How
@@ -21,14 +21,15 @@ shows exactly what your AI agent is about to tap, and token-efficient UI snapsho
21
21
  text instead of screenshots. Record any screen as an MP4 or a GIF for a pull request. Works with Claude Code, Codex,
22
22
  Cursor and any other MCP client.
23
23
 
24
- > **Status: 2.3.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
24
+ > **Status: 2.4.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
25
25
  > release to [what SimMirror promises not to break](docs/stability.md). 2.0 brought real iPhones and iPads beside the
26
26
  > simulators -- live over the cable, driven through WebDriverAgent -- and records any screen as an MP4 or a GIF. 2.1
27
27
  > reads and touches apps turned to landscape, keeps taps off what a tab bar covers, builds the worktree the agent works
28
28
  > in, and adds observe mode for walkthroughs on accounts an agent must not change. 2.2 adds Android emulators and
29
29
  > phones, with the same viewer, cursor and tools. 2.3 attaches a real device again by itself once a pulled cable is
30
- > back, tells an agent why it cannot touch one, and checks one before a run with `sim_device health`. It removes
31
- > nothing 1.x promised.
30
+ > back, tells an agent why it cannot touch one, and checks one before a run with `sim_device health`. 2.4 leaves a
31
+ > phone a person took back alone, records as long as it ran, reads long screens without locking WebDriverAgent up, waits
32
+ > for exact words, and lets one agent at a time drive a real device. It removes nothing 1.x promised.
32
33
 
33
34
  ## Why SimMirror
34
35
 
@@ -42,6 +43,9 @@ Cursor and any other MCP client.
42
43
  share its own views, so icon-only buttons and hand-drawn controls read by name.
43
44
  - **Test on a real iPhone.** Plug it in and it sits beside the simulators: live over the cable at up to 60 fps, touched
44
45
  and typed on from the browser or by an agent, and given back everything SimMirror changed on it.
46
+ - **Check connection recovery.** Open Control Center on a real iPhone to manage Wi-Fi and Bluetooth connections or
47
+ toggle airplane mode, then return to your app to check how it reconnects to a BLE or Wi-Fi accessory.
48
+ See [the connectivity workflow](docs/real-devices.md#connectivity-workflows).
45
49
  - **Show what happened.** Record a flow as an MP4 or a GIF with every touch drawn in, and put it in a pull request.
46
50
 
47
51
  ## Install
@@ -56,16 +60,17 @@ Cursor and any other MCP client.
56
60
  **Any MCP client**, as a stdio server:
57
61
 
58
62
  ```sh
59
- claude mcp add sim-mirror -- uvx --from sim-mirror==2.3.0 sim-mirror mcp
63
+ claude mcp add sim-mirror -- uvx --from sim-mirror==2.5.0 sim-mirror mcp
60
64
  ```
61
65
 
62
66
  Configurations for [Codex](docs/clients/codex.md), [Cursor](docs/clients/cursor.md) and
63
67
  [other clients](docs/clients/other-mcp.md).
68
+ The plugin includes four [workflow skills](docs/clients/skills.md); the release also packages them for Codex and Cursor.
64
69
 
65
70
  **The command**, for `sim-mirror open`, `doctor` and the rest:
66
71
 
67
72
  ```sh
68
- uv tool install sim-mirror==2.3.0
73
+ uv tool install sim-mirror==2.5.0
69
74
  # or
70
75
  brew install andrewkochulab/tap/sim-mirror
71
76
  ```
@@ -127,7 +132,7 @@ gesture or a hand-drawn control reads by name, and `.simMirror("Settings")` name
127
132
  of it is in a Release build. See [The app SDK](docs/app-sdk.md).
128
133
 
129
134
  **Real devices.** A cabled iPhone or iPad shows up beside the simulators, and an agent can switch to it
130
- (`sim_device list` and `choose`): its live screen over the cable, at about 55 frames a second; its apps, logs, look and
135
+ (`sim_device list` and `choose`): its live screen over the cable; its apps, logs, look and
131
136
  location through Xcode's `devicectl`; and touching, typing and its element tree through WebDriverAgent, set up once
132
137
  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
133
138
  the cable, and what SimMirror changes on it is put back when it is let go. See [Real devices](docs/real-devices.md).
@@ -169,19 +174,26 @@ set build.tools true`.
169
174
  ## Measure the token cost
170
175
 
171
176
  `benchmarks/tool_budget.py` calls each read-only tool through the same MCP relay a client uses and prints each answer's
172
- bytes, estimated tokens and latency on your own screens; see [the token budget example](examples/token-budget/). On
173
- an iPhone 17 Pro simulator (iOS 26.5, idb connector) showing Settings → General, 5 calls each (2026-09-16):
177
+ bytes, estimated tokens and latency on your own screens; see [the token budget example](examples/token-budget/).
178
+ Measured with SimMirror 2.4.0 on an iOS simulator using the native connector, showing Settings → General:
179
+ 30 calls per tool after a separate initial round and 3 warmup rounds (2026-10-29). Host and device details are omitted
180
+ from the public report for privacy.
174
181
 
175
182
  | Call | Tool | Bytes | Tokens (est.) | p50 ms | p95 ms |
176
183
  |---|---|---:|---:|---:|---:|
177
- | device info | `sim_device` | 265 | 46 | 2.9 | 3.6 |
178
- | snapshot, full | `sim_snapshot` | 561 | 112 | 64.8 | 76.4 |
179
- | snapshot, diff of an unchanged screen | `sim_snapshot` | 83 | 5 | 63.2 | 64.8 |
180
- | screenshot, 400 px wide | `sim_screenshot` | 62222 | 469 | 8.2 | 8.9 |
181
- | screenshot, 1200 px wide | `sim_screenshot` | 276472 | 4181 | 20.4 | 21.9 |
184
+ | device info | `sim_device` | 275 | 49 | 260.1 | 282.9 |
185
+ | snapshot, full | `sim_snapshot` | 561 | 112 | 74.3 | 83.3 |
186
+ | snapshot, diff of an unchanged screen | `sim_snapshot` | 83 | 5 | 66.5 | 73.5 |
187
+ | screenshot, 400 px wide | `sim_screenshot` | 55958 | 469 | 15.5 | 17.0 |
188
+ | screenshot, 1200 px wide | `sim_screenshot` | 251484 | 4181 | 24.2 | 25.8 |
189
+
190
+ On a physical iOS device over USB with WebDriverAgent, the same 30-round run measured 199 estimated tokens for a
191
+ full snapshot (p50 859.1 ms), 5 for an unchanged-screen diff (817.9 ms), and 469 for a 400-pixel screenshot (31.4 ms).
182
192
 
183
193
  Bytes are the whole answer, an image's base64 included; tokens are estimates (text at about 4 characters a token,
184
- an image at about 750 pixels a token).
194
+ an image at about 750 pixels a token), not billed usage or whole-task costs. All measured calls succeeded. See the
195
+ [performance report](docs/performance.md) for real-iPhone results, initial-call timings, raw samples and the older
196
+ baseline. Different connectors and environments make these separate observations, not a before/after speedup claim.
185
197
 
186
198
  ## Compatibility
187
199
 
@@ -219,7 +231,8 @@ the [command line](docs/reference/cli.md) and the [protocol](docs/reference/prot
219
231
  | **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 |
220
232
  | **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 |
221
233
  | **v2.2** | Android emulators and phones with the same viewer, cursor and tools: adb, scrcpy's live screen, and Gradle builds |
222
- | **v2.3** (now) | Real devices that recover from a pulled cable by themselves, `sim_device health`, an agent told why a device cannot be touched, and a text reader a slow reading no longer locks out |
234
+ | **v2.3** | Real devices that recover from a pulled cable by themselves, `sim_device health`, an agent told why a device cannot be touched, and a text reader a slow reading no longer locks out |
235
+ | **v2.4** (now) | Agents that hold up on a real iPhone: WebDriverAgent left alone once a person takes the phone back, recordings as long as they ran, long screens read without locking up, exact and regex waits, refs checked before a tap, iOS 27's floating search bar, and one agent at a time per device |
223
236
  | **Website & launch** | Landing page, video tutorials and guides |
224
237
 
225
238
  See [ROADMAP.md](ROADMAP.md) and the [milestones](https://github.com/AndrewKochulab/sim-mirror/milestones). How
@@ -12,6 +12,7 @@
12
12
  - [OpenAI Codex](clients/codex.md)
13
13
  - [Cursor](clients/cursor.md)
14
14
  - [Any other MCP client](clients/other-mcp.md)
15
+ - [Agent skills](clients/skills.md) -- workflows, portable installation and updates
15
16
 
16
17
  ## Use it with a real device or Android, and record
17
18
 
@@ -36,6 +37,7 @@
36
37
  ## How it works
37
38
 
38
39
  - [Screen understanding](screen-understanding.md) -- snapshots, refs, diffs, waits, and what each costs
40
+ - [Performance measurements](performance.md) -- dated tool latency and response-cost results, raw samples and limits
39
41
  - [Connectors](connectors.md) -- how SimMirror reaches a device, and what each can do
40
42
  - [The app SDK](app-sdk.md) -- an app under development shares its own UIKit and SwiftUI views, so screens
41
43
  without accessibility labels read well
@@ -56,6 +58,7 @@
56
58
 
57
59
  - [Contributing](../CONTRIBUTING.md) and [the guide for AI coding agents](../AGENTS.md)
58
60
  - [Writing a connector](contributing/connector-guide.md)
61
+ - [Validating agent skills](contributing/skill-validation.md)
59
62
  - [Roadmap](roadmap.md)
60
63
 
61
64
  The reference pages and the compatibility table are generated from the code (`make generate`); edit their sources, not
@@ -17,7 +17,7 @@ Its tools are named `mcp__plugin_sim-mirror_device__sim_snapshot` and so on (`mc
17
17
  ## Without the plugin
18
18
 
19
19
  ```sh
20
- claude mcp add sim-mirror -- uvx --from sim-mirror==2.3.0 sim-mirror mcp
20
+ claude mcp add sim-mirror -- uvx --from sim-mirror==2.5.0 sim-mirror mcp
21
21
  ```
22
22
 
23
23
  Add `--scope project` before the name to write it to the project's `.mcp.json` for everyone working on it. Its tools
@@ -31,7 +31,7 @@ simulator (its scope) and this folder as the only place builds and installs may
31
31
  ## Watch it
32
32
 
33
33
  ```sh
34
- uvx --from sim-mirror==2.3.0 sim-mirror open
34
+ uvx --from sim-mirror==2.5.0 sim-mirror open
35
35
  ```
36
36
 
37
37
  opens this folder's viewer in your browser. Every gesture the agent makes is drawn there as a cursor just before it
@@ -6,7 +6,7 @@ Add [config.toml](config.toml)'s table to `~/.codex/config.toml`, then start Cod
6
6
  and installs may reach. The commented `args` pin a project by name and path instead.
7
7
  - `tool_timeout_sec` is raised because `sim_build_run` and `sim_test` can take minutes (they are there only when build
8
8
  tools are switched on).
9
- - Watch and take over in a browser: `uvx --from sim-mirror==2.3.0 sim-mirror open`
9
+ - Watch and take over in a browser: `uvx --from sim-mirror==2.5.0 sim-mirror open`
10
10
  in the same folder.
11
11
 
12
12
  The tools are the same for every client; see [claude-code-cli](../claude-code-cli/) for a first prompt to try.
@@ -6,7 +6,7 @@ one), and enable the server in Cursor's MCP settings.
6
6
  - `sim-mirror mcp` gives the agent the simulator of the folder it starts in, and that folder as the only place builds
7
7
  and installs may reach. If the tools act on the wrong project, append `"--scope", "my-app", "--root",
8
8
  "/absolute/path/to/my-app"` to `args`.
9
- - Watch and take over in a browser: `uvx --from sim-mirror==2.3.0 sim-mirror open`
9
+ - Watch and take over in a browser: `uvx --from sim-mirror==2.5.0 sim-mirror open`
10
10
  in the same folder.
11
11
 
12
12
  The tools are the same for every client; see [claude-code-cli](../claude-code-cli/) for a first prompt to try.
@@ -5,7 +5,7 @@ A Python application with SimMirror inside it: [app.py](app.py). No daemon runs;
5
5
 
6
6
  ```sh
7
7
  cd examples/fastapi-embed
8
- EXAMPLE_KEY=change-me uv run --with "sim-mirror==2.3.0" \
8
+ EXAMPLE_KEY=change-me uv run --with "sim-mirror==2.5.0" \
9
9
  uvicorn --factory app:create_app --port 7484
10
10
  ```
11
11
 
@@ -0,0 +1,48 @@
1
+ # Token budget
2
+
3
+ What each tool's answer costs an agent, measured on your own screens with
4
+ [benchmarks/tool_budget.py](../../benchmarks/tool_budget.py).
5
+
6
+ ```sh
7
+ sim-mirror open --scope demo # start the device and put something on its screen
8
+ uv run python benchmarks/tool_budget.py --scope demo --runs 5
9
+ ```
10
+
11
+ For a result to publish, prepare a named screen and connector, then keep a separate initial round, three warmup
12
+ rounds and 30 measured rounds in one MCP session:
13
+
14
+ ```sh
15
+ uv run python benchmarks/tool_budget.py --scope demo --warmup 3 --runs 30 --report > tool-budget.json
16
+ ```
17
+
18
+ `--report` writes JSON with the package version, the initial round, warmup summaries, measured summaries and every
19
+ measured duration, byte count and token estimate. It stores no screenshot pixels or screen text. Keep detailed host
20
+ and device information in private notes; publish only the public source revision, generic device class, connector
21
+ and workload. Do not attach device-info output, identifiers, account names, paths or screen contents. Check every row's `errors`
22
+ before publishing; a failed call's small error message is not a successful snapshot's token cost.
23
+
24
+ The initial round is each tool's first call in this MCP session, in the listed order. It is **not** a cold device or
25
+ daemon startup benchmark: the device may already be running and the screen may have been read during preparation.
26
+ Warmup rounds are excluded from the measured percentiles. `--warmup` defaults to zero; `--json` still prints only the
27
+ measured summary rows. The p95 uses nearest rank: with five calls it is the slowest call, which is why the published
28
+ refresh uses 30 calls per tool.
29
+
30
+ See [the dated performance report](../../docs/performance.md) for the current results and historical baselines.
31
+
32
+ It starts `sim-mirror mcp` for the scope, speaks MCP to it over stdio as a client does, and calls each read-only tool
33
+ `--runs` times: device info, a full snapshot, a diff snapshot of the unchanged screen, and screenshots at 400 and 1200
34
+ pixels wide. Nothing is tapped or typed. For each call it prints a Markdown table row:
35
+
36
+ | Column | Meaning |
37
+ |---|---|
38
+ | Bytes | The answer as JSON, as it reaches the client (median) |
39
+ | Tokens (est.) | Text at about 4 characters a token, an image at about 750 pixels a token (median) |
40
+ | p50 ms, p95 ms | Latency through the relay and the daemon |
41
+ | Errors | Calls that answered with an error |
42
+
43
+ `--json` prints the same rows as JSON. The token counts are estimates -- each model counts its own way -- and are for
44
+ comparing answers with each other, not for billing.
45
+
46
+ These are response costs, excluding tool definitions, prompts, model reasoning and conversation history. They do not
47
+ measure tokens or elapsed time for completing a whole task. The benchmark does not tap, scroll, build, record, test
48
+ reconnection, or exercise `sim_screenshot save_to`, `return_image: false` or `sim_snapshot max_elements`.
@@ -41,15 +41,20 @@ public struct RenderJob: Equatable, Sendable, Codable {
41
41
  public let mp4Width: Int
42
42
  /// How many bits the MP4 spends on its size; a job that does not say is `high`, as every MP4 was before.
43
43
  public let mp4Quality: MovieQuality
44
+ /// How long the recording ran by the clock, in seconds: a still screen sends its last picture long before the
45
+ /// recording stops. 0, or a job from a SimMirror that did not say, is as long as its pictures run.
46
+ public let durationS: Double
44
47
 
45
48
  public static let speeds = 0.25...8.0
46
49
  public static let gifFpsRange = 1...30
47
50
  public static let gifWidthRange = 64...2000
48
51
  public static let mp4WidthRange = 0...4000
52
+ /// Up to a day: longer than any recording SimMirror lets run.
53
+ public static let durationRange = 0.0...86_400
49
54
 
50
55
  enum CodingKeys: String, CodingKey {
51
56
  case input, inputKind = "input_kind", touches, mp4, gif, codec, speed, gifFps = "gif_fps", gifWidth = "gif_width"
52
- case mp4Width = "mp4_width", mp4Quality = "mp4_quality"
57
+ case mp4Width = "mp4_width", mp4Quality = "mp4_quality", durationS = "duration_s"
53
58
  }
54
59
 
55
60
  public init(from decoder: Decoder) throws {
@@ -65,11 +70,24 @@ public struct RenderJob: Equatable, Sendable, Codable {
65
70
  gifWidth = try values.decode(Int.self, forKey: .gifWidth)
66
71
  mp4Width = try values.decodeIfPresent(Int.self, forKey: .mp4Width) ?? 0
67
72
  mp4Quality = try values.decodeIfPresent(MovieQuality.self, forKey: .mp4Quality) ?? .high
73
+ durationS = try values.decodeIfPresent(Double.self, forKey: .durationS) ?? 0
68
74
  }
69
75
 
70
76
  /// The width the MP4 is drawn no wider than, or nil for the recording's own.
71
77
  public var movieWidth: Int? { mp4Width > 0 ? mp4Width : nil }
72
78
 
79
+ /// How long the recording runs, in seconds: as long as it ran by the clock, or as its pictures run when they run
80
+ /// longer -- never cut short at the last picture a still screen sent.
81
+ public func length(of pictures: Double) -> Double {
82
+ max(pictures.isFinite ? pictures : 0, durationS)
83
+ }
84
+
85
+ /// The frames a file of this job is made of, at `fps` a second, for a recording whose pictures run `pictures`
86
+ /// seconds.
87
+ public func ticks(pictures: Double, fps: Int) -> Ticks {
88
+ Ticks.make(duration: length(of: pictures), speed: speed, fps: fps)
89
+ }
90
+
73
91
  /// A job read from SimMirror's JSON, refused when it asks for something that cannot be made.
74
92
  public static func read(_ data: Data) throws -> RenderJob {
75
93
  let job: RenderJob
@@ -84,6 +102,7 @@ public struct RenderJob: Equatable, Sendable, Codable {
84
102
  guard gifFpsRange.contains(job.gifFps) else { throw HelperFailure("gif_fps must be 1 to 30", status: 400) }
85
103
  guard gifWidthRange.contains(job.gifWidth) else { throw HelperFailure("gif_width must be 64 to 2000", status: 400) }
86
104
  guard mp4WidthRange.contains(job.mp4Width) else { throw HelperFailure("mp4_width must be 0 to 4000", status: 400) }
105
+ guard durationRange.contains(job.durationS) else { throw HelperFailure("duration_s must be 0 to 86400", status: 400) }
87
106
  return job
88
107
  }
89
108
  }
@@ -217,6 +236,31 @@ public struct Ticks: Equatable, Sendable {
217
236
  public var length: Double { Double(times.count) / Double(fps) }
218
237
  }
219
238
 
239
+ /// Moves a recording's pictures on to a moment: keeps the last one shown by then, reading ahead one picture. Past the
240
+ /// last picture it keeps showing that one, so a recording that ran on after its screen stopped changing still shows it
241
+ /// to the end.
242
+ public struct Playhead<Picture> {
243
+ public private(set) var shown: Picture?
244
+ private var ahead: (time: Double, picture: Picture)?
245
+ private var ended = false
246
+
247
+ public init() {}
248
+
249
+ /// The picture shown at `time`: the last one `next` gave whose time is not after it, or the first one, before any.
250
+ public mutating func advance(to time: Double, next: () throws -> (time: Double, picture: Picture)?) rethrows -> Picture? {
251
+ while !ended {
252
+ if ahead == nil {
253
+ ahead = try next()
254
+ if ahead == nil { ended = true; break }
255
+ }
256
+ guard let upcoming = ahead, upcoming.time <= time || shown == nil else { break }
257
+ shown = upcoming.picture
258
+ ahead = nil
259
+ }
260
+ return shown
261
+ }
262
+ }
263
+
220
264
  /// The size a rendered file is drawn at: the recording's own, no wider than `width`, both sides even as H.264 wants.
221
265
  public func renderedSize(sourceWidth: Int, sourceHeight: Int, width: Int?) -> (width: Int, height: Int) {
222
266
  guard sourceWidth > 0, sourceHeight > 0 else { return (2, 2) }
@@ -3,7 +3,7 @@ import Foundation
3
3
 
4
4
  /// The helper's version, which is SimMirror's: SimMirror refuses a helper of another version.
5
5
  public enum HelperVersion {
6
- public static let current = "2.3.0"
6
+ public static let current = "2.5.0"
7
7
  }
8
8
 
9
9
  /// What a frame on the socket is.
@@ -12,7 +12,9 @@ import VideoToolbox
12
12
  /// Renders a recording as SimMirror asks (`RenderJob`): an MP4 and a GIF, each at a steady rate in its own time (`Ticks`),
13
13
  /// each frame the recording's picture at that moment with the touches that were landing then drawn over it
14
14
  /// (`TouchMarks`). The recording is a movie the device's own tool wrote, or SimMirror's frame file of H.264 access units
15
- /// or JPEGs -- all read forward once for each file written.
15
+ /// or JPEGs -- all read forward once for each file written. Each file runs as long as the recording ran by the clock,
16
+ /// its last picture held to the end (`RenderJob.length`). A file that cannot be finished is removed, never left half
17
+ /// written.
16
18
  public enum RecordingRenderer {
17
19
  /// Frames a second in a rendered MP4.
18
20
  public static let movieFps = 30
@@ -48,26 +50,6 @@ protocol PictureSource {
48
50
  mutating func picture(at time: Double) throws -> CIImage?
49
51
  }
50
52
 
51
- /// Moves a source's pictures on to a moment: keeps the last one shown by then, reading ahead one picture.
52
- struct Playhead {
53
- private(set) var shown: CIImage?
54
- private var ahead: (time: Double, image: CIImage)?
55
- private var ended = false
56
-
57
- mutating func advance(to time: Double, next: () throws -> (time: Double, image: CIImage)?) rethrows -> CIImage? {
58
- while !ended {
59
- if ahead == nil {
60
- ahead = try next()
61
- if ahead == nil { ended = true; break }
62
- }
63
- guard let upcoming = ahead, upcoming.time <= time || shown == nil else { break }
64
- shown = upcoming.image
65
- ahead = nil
66
- }
67
- return shown
68
- }
69
- }
70
-
71
53
  /// A movie's pictures, through AVAssetReader.
72
54
  struct MoviePictures: PictureSource {
73
55
  let width: Int
@@ -76,7 +58,7 @@ struct MoviePictures: PictureSource {
76
58
  private let reader: AVAssetReader
77
59
  private let output: AVAssetReaderTrackOutput
78
60
  private let transform: CGAffineTransform
79
- private var playhead = Playhead()
61
+ private var playhead = Playhead<CIImage>()
80
62
 
81
63
  init(url: URL) async throws {
82
64
  let asset = AVURLAsset(url: url)
@@ -114,7 +96,7 @@ struct FramePictures: PictureSource {
114
96
  let duration: Double
115
97
  private var reader: FrameFile.Reader
116
98
  private let decoder = H264Decoder()
117
- private var playhead = Playhead()
99
+ private var playhead = Playhead<CIImage>()
118
100
 
119
101
  init(url: URL) throws {
120
102
  var scan = try FramePictures.open(url)
@@ -285,8 +267,17 @@ enum Frames {
285
267
  /// through AVAssetWriter. It has no sound: a recording has none.
286
268
  enum MovieWriter {
287
269
  static func write(_ source: inout any PictureSource, job: RenderJob, to url: URL) async throws -> RenderedFile {
288
- let (width, height) = renderedSize(sourceWidth: source.width, sourceHeight: source.height, width: job.movieWidth)
289
270
  try? FileManager.default.removeItem(at: url)
271
+ do {
272
+ return try await written(&source, job: job, to: url)
273
+ } catch {
274
+ try? FileManager.default.removeItem(at: url)
275
+ throw error
276
+ }
277
+ }
278
+
279
+ private static func written(_ source: inout any PictureSource, job: RenderJob, to url: URL) async throws -> RenderedFile {
280
+ let (width, height) = renderedSize(sourceWidth: source.width, sourceHeight: source.height, width: job.movieWidth)
290
281
  let writer = try AVAssetWriter(outputURL: url, fileType: .mp4)
291
282
  let bitrate = job.mp4Quality.bitrate(width: width, height: height)
292
283
  let input = AVAssetWriterInput(mediaType: .video, outputSettings: [
@@ -305,7 +296,7 @@ enum MovieWriter {
305
296
  guard writer.startWriting() else { throw HelperFailure("the MP4 cannot be written: \(writer.error?.localizedDescription ?? "no reason")") }
306
297
  writer.startSession(atSourceTime: .zero)
307
298
  let context = CIContext(options: [.cacheIntermediates: false])
308
- let ticks = Ticks.make(duration: source.duration, speed: job.speed, fps: RecordingRenderer.movieFps)
299
+ let ticks = job.ticks(pictures: source.duration, fps: RecordingRenderer.movieFps)
309
300
  for (index, tick) in ticks.times.enumerated() {
310
301
  guard let picture = try source.picture(at: tick.source) else { continue }
311
302
  while !input.isReadyForMoreMediaData { try await Task.sleep(nanoseconds: 2_000_000) }
@@ -320,6 +311,8 @@ enum MovieWriter {
320
311
  }
321
312
  }
322
313
  input.markAsFinished()
314
+ // The last frame shows until the file's end, not only for the moment it began.
315
+ writer.endSession(atSourceTime: CMTime(value: CMTimeValue(ticks.times.count), timescale: CMTimeScale(ticks.fps)))
323
316
  await writer.finishWriting()
324
317
  guard writer.status == .completed else { throw HelperFailure("the MP4 was not finished: \(writer.error?.localizedDescription ?? "no reason")") }
325
318
  return RenderedFile(path: url.path, format: "mp4", width: width, height: height, durationS: ticks.length)
@@ -329,8 +322,18 @@ enum MovieWriter {
329
322
  /// An animated GIF at its own width and rate, through ImageIO; a frame the same as the one before only lengthens it.
330
323
  enum GIFWriter {
331
324
  static func write(_ source: inout any PictureSource, job: RenderJob, to url: URL) throws -> RenderedFile {
325
+ do {
326
+ return try written(&source, job: job, to: url)
327
+ } catch {
328
+ try? FileManager.default.removeItem(at: url)
329
+ throw error
330
+ }
331
+ }
332
+
333
+ /// ImageIO is told the most frames there can be; a frame the same as the one before is left out, which it allows.
334
+ private static func written(_ source: inout any PictureSource, job: RenderJob, to url: URL) throws -> RenderedFile {
332
335
  let (width, height) = renderedSize(sourceWidth: source.width, sourceHeight: source.height, width: job.gifWidth)
333
- let ticks = Ticks.make(duration: source.duration, speed: job.speed, fps: job.gifFps)
336
+ let ticks = job.ticks(pictures: source.duration, fps: job.gifFps)
334
337
  guard let destination = CGImageDestinationCreateWithURL(url as CFURL, UTType.gif.identifier as CFString, ticks.times.count, nil) else {
335
338
  throw HelperFailure("ImageIO cannot write a GIF here")
336
339
  }
@@ -153,4 +153,64 @@ import Testing
153
153
  #expect(AnnexB.nalUnits(Data([1, 2, 3])).isEmpty && AnnexB.type(Data()) == 0)
154
154
  #expect(AnnexB.nalUnits(Data([0, 0, 1, 0, 0, 1, 0x41])) == [Data([0x41])])
155
155
  }
156
+
157
+ static func lasting(_ seconds: String, speed: String = "1") throws -> RenderJob {
158
+ let asked = job
159
+ .replacingOccurrences(of: #""gif_width":600"#, with: #""gif_width":600,"duration_s":\#(seconds)"#)
160
+ .replacingOccurrences(of: #""speed":2"#, with: #""speed":\#(speed)"#)
161
+ return try RenderJob.read(Data(asked.utf8))
162
+ }
163
+
164
+ @Test func aRecordingOfAStillScreenRunsAsLongAsItRanByTheClock() throws {
165
+ // 120 s recorded, the screen's last picture sent 0.3 s in: the file still plays 120 s.
166
+ let still = try Self.lasting("120")
167
+ #expect(still.durationS == 120 && still.length(of: 0.3) == 120)
168
+ let movie = still.ticks(pictures: 0.3, fps: 30)
169
+ #expect(movie.length == 120 && movie.times.count == 3600 && movie.times.last?.source ?? 0 < 120)
170
+ #expect(still.ticks(pictures: 0.3, fps: 12).length == 120)
171
+ #expect(try Self.lasting("120", speed: "2").ticks(pictures: 0.3, fps: 30).length == 60)
172
+ }
173
+
174
+ @Test func pictureLongerThanTheClockSaysOrAnUnknownLengthIsWhatCounts() throws {
175
+ let job = try Self.lasting("2.5")
176
+ #expect(job.length(of: 4) == 4 && job.length(of: .nan) == 2.5 && job.length(of: .infinity) == 2.5)
177
+ // A SimMirror that does not say how long it ran renders as long as the pictures run, as before.
178
+ let older = try RenderJob.read(Data(Self.job.utf8))
179
+ #expect(older.durationS == 0 && older.length(of: 3) == 3)
180
+ #expect(older.ticks(pictures: 3, fps: 4) == Ticks.make(duration: 3, speed: 2, fps: 4))
181
+ }
182
+
183
+ @Test(arguments: ["-1", "86401"])
184
+ func aDurationNoRecordingCouldHaveIsRefused(seconds: String) {
185
+ do {
186
+ _ = try Self.lasting(seconds)
187
+ Issue.record("\(seconds) was read")
188
+ } catch {
189
+ #expect((error as? HelperFailure)?.message == "duration_s must be 0 to 86400")
190
+ }
191
+ }
192
+
193
+ @Test func thePlayheadHoldsTheLastPictureToTheEnd() {
194
+ var pictures: [(time: Double, picture: String)] = [(0.4, "a"), (1, "b"), (2, "c")]
195
+ var asked = 0
196
+ var playhead = Playhead<String>()
197
+ func next() -> (time: Double, picture: String)? {
198
+ asked += 1
199
+ return pictures.isEmpty ? nil : pictures.removeFirst()
200
+ }
201
+ #expect(playhead.advance(to: 0, next: next) == "a", "the first picture shows from the start")
202
+ #expect(playhead.advance(to: 0.9, next: next) == "a")
203
+ #expect(playhead.advance(to: 1, next: next) == "b" && playhead.shown == "b")
204
+ #expect(playhead.advance(to: 5, next: next) == "c")
205
+ let read = asked
206
+ #expect(playhead.advance(to: 120, next: next) == "c", "the last picture holds long after it was sent")
207
+ #expect(asked == read, "nothing more is read once the pictures end")
208
+ }
209
+
210
+ @Test func aPlayheadWithNoPicturesShowsNoneAndPassesOnWhatReadingThrows() throws {
211
+ var empty = Playhead<Int>()
212
+ #expect(empty.advance(to: 1) { nil } == nil && empty.shown == nil)
213
+ var broken = Playhead<Int>()
214
+ #expect(throws: HelperFailure.self) { try broken.advance(to: 1) { throw HelperFailure("a recorded frame cannot be read") } }
215
+ }
156
216
  }